<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  <title> - 服务计算 - 中山大学</title>
  <meta name="renderer" content="webkit" />
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"/>

<meta http-equiv="Cache-Control" content="no-transform" />
<meta http-equiv="Cache-Control" content="no-siteapp" />

<meta name="theme-color" content="#f8f5ec" />
<meta name="msapplication-navbutton-color" content="#f8f5ec">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="#f8f5ec">


<meta name="author" content="潘茂林" /><meta name="description" content="CLI 命令行实用程序开发实战 - Agenda {:.no_toc} 目录 {:toc} 1、概述 命令行实用程序并不是都象 cat、more、grep 是简单命令。go 项目管理程序，类似 java 项目管理 m" /><meta name="keywords" content="中山大学, 数据科学与计算机, 服务计算" />






<meta name="generator" content="Hugo 0.74.3 with theme even" />


<link rel="canonical" href="http://pmlpml.git.io/service-computing/post/ex-cli-agenda/" />
<link rel="apple-touch-icon" sizes="180x180" href="/service-computing/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/service-computing/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/service-computing/favicon-16x16.png">
<link rel="manifest" href="/service-computing/manifest.json">
<link rel="mask-icon" href="/service-computing/safari-pinned-tab.svg" color="#5bbad5">



<link href="/service-computing/sass/main.min.8c3cbcb0324c2bb4875ceccba4007cbad4b4ac8377f33af9953c3e7684534a50.css" rel="stylesheet">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@3.1.20/dist/jquery.fancybox.min.css" integrity="sha256-7TyXnr2YU040zfSP+rEcz29ggW4j56/ujTPwjMzyqFY=" crossorigin="anonymous">


<meta property="og:title" content="" />
<meta property="og:description" content="CLI 命令行实用程序开发实战 - Agenda {:.no_toc} 目录 {:toc} 1、概述 命令行实用程序并不是都象 cat、more、grep 是简单命令。go 项目管理程序，类似 java 项目管理 m" />
<meta property="og:type" content="article" />
<meta property="og:url" content="http://pmlpml.git.io/service-computing/post/ex-cli-agenda/" />

<meta itemprop="name" content="">
<meta itemprop="description" content="CLI 命令行实用程序开发实战 - Agenda {:.no_toc} 目录 {:toc} 1、概述 命令行实用程序并不是都象 cat、more、grep 是简单命令。go 项目管理程序，类似 java 项目管理 m">

<meta itemprop="wordCount" content="3431">



<meta itemprop="keywords" content="" />
<meta name="twitter:card" content="summary"/>
<meta name="twitter:title" content=""/>
<meta name="twitter:description" content="CLI 命令行实用程序开发实战 - Agenda {:.no_toc} 目录 {:toc} 1、概述 命令行实用程序并不是都象 cat、more、grep 是简单命令。go 项目管理程序，类似 java 项目管理 m"/>

<!--[if lte IE 9]>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/classlist/1.1.20170427/classList.min.js"></script>
<![endif]-->

<!--[if lt IE 9]>
  <script src="https://cdn.jsdelivr.net/npm/html5shiv@3.7.3/dist/html5shiv.min.js"></script>
  <script src="https://cdn.jsdelivr.net/npm/respond.js@1.4.2/dest/respond.min.js"></script>
<![endif]-->

</head>
<body>
  <div id="mobile-navbar" class="mobile-navbar">
  <div class="mobile-header-logo">
    <a href="/service-computing/" class="logo">服务计算</a>
  </div>
  <div class="mobile-navbar-icon">
    <span></span>
    <span></span>
    <span></span>
  </div>
</div>
<nav id="mobile-menu" class="mobile-menu slideout-menu">
  <ul class="mobile-menu-list">
    <a href="/service-computing/post/index-2020">
        <li class="mobile-menu-item">首页</li>
      </a><a href="/service-computing/post/">
        <li class="mobile-menu-item">归档</li>
      </a><a href="/service-computing/tags/">
        <li class="mobile-menu-item">标签</li>
      </a><a href="/service-computing/about/">
        <li class="mobile-menu-item">关于</li>
      </a>
  </ul>
</nav>
  <div class="container" id="mobile-panel">
    <header id="header" class="header">
        <div class="logo-wrapper">
  <a href="/service-computing/" class="logo">服务计算</a>
</div>

<nav class="site-navbar">
  <ul id="menu" class="menu">
    <li class="menu-item">
        <a class="menu-item-link" href="/service-computing/post/index-2020">首页</a>
      </li><li class="menu-item">
        <a class="menu-item-link" href="/service-computing/post/">归档</a>
      </li><li class="menu-item">
        <a class="menu-item-link" href="/service-computing/tags/">标签</a>
      </li><li class="menu-item">
        <a class="menu-item-link" href="/service-computing/about/">关于</a>
      </li>
  </ul>
</nav>
    </header>

    <main id="main" class="main">
      <div class="content-wrapper">
        <div id="content" class="content">
          <article class="post">
    
    <header class="post-header">
      <h1 class="post-title"></h1>

      <div class="post-meta">
        <span class="post-time"> 0001-01-01 </span>
        
        
      </div>
    </header>

    <div class="post-toc" id="post-toc">
  <h2 class="post-toc-title"></h2>
  <div class="post-toc-content always-active">
    <nav id="TableOfContents">
  <ul>
    <li><a href="#cli-命令行实用程序开发实战---agenda">CLI 命令行实用程序开发实战 - Agenda</a>
      <ul>
        <li><a href="#1概述">1、概述</a></li>
        <li><a href="#2go-命令">2、GO 命令</a>
          <ul>
            <li><a href="#21-go-命令的格式">2.1 go 命令的格式</a></li>
            <li><a href="#22-go-命令分类">2.2 go 命令分类</a></li>
          </ul>
        </li>
        <li><a href="#3准备知识或资源">3、准备知识或资源</a>
          <ul>
            <li><a href="#31-golang-知识整理">3.1 Golang 知识整理</a></li>
            <li><a href="#32-json-序列化与反序列化">3.2 JSON 序列化与反序列化</a></li>
            <li><a href="#33-复杂命令行的处理">3.3 复杂命令行的处理</a></li>
          </ul>
        </li>
        <li><a href="#4agenda-开发项目">4、agenda 开发项目</a>
          <ul>
            <li><a href="#41-需求描述">4.1 需求描述</a></li>
            <li><a href="#42-第一周任务">4.2 第一周任务</a></li>
            <li><a href="#43-第二周任务">4.3 第二周任务</a></li>
            <li><a href="#44-可选任务博客">4.4 可选任务（博客）</a></li>
            <li><a href="#45-评价标准">4.5 评价标准</a></li>
          </ul>
        </li>
        <li><a href="#附件agenda-业务需求">附件：Agenda 业务需求</a></li>
      </ul>
    </li>
  </ul>
</nav>
  </div>
</div>
    <div class="post-content">
      <h1 id="cli-命令行实用程序开发实战---agenda">CLI 命令行实用程序开发实战 - Agenda</h1>
<p>{:.no_toc}</p>
<ul>
<li>目录
{:toc}</li>
</ul>
<h2 id="1概述">1、概述</h2>
<p>  命令行实用程序并不是都象 cat、more、grep 是简单命令。<a href="https://go-zh.org/cmd/go/">go</a> 项目管理程序，类似 java 项目管理 <a href="http://maven.apache.org/">maven</a>、Nodejs 项目管理程序 <a href="https://www.npmjs.com/">npm</a>、git 命令行客户端、 docker 与 kubernetes 容器管理工具等等都是采用了较复杂的命令行。即一个实用程序同时支持多个子命令，每个子命令有各自独立的参数，命令之间可能存在共享的代码或逻辑，同时随着产品的发展，这些命令可能发生功能变化、添加新命令等。因此，符合 <a href="https://en.wikipedia.org/wiki/Open/closed_principle">OCP 原则</a> 的设计是至关重要的编程需求。</p>
<p><strong>任务目标</strong></p>
<ol>
<li>熟悉 go 命令行工具管理项目</li>
<li>综合使用 go 的函数、数据结构与接口，编写一个简单命令行应用 agenda</li>
<li>使用面向对象的思想设计程序，使得程序具有良好的结构命令，并能方便修改、扩展新的命令,不会影响其他命令的代码</li>
<li>项目部署在 Github 上，合适多人协作，特别是代码归并</li>
<li>支持日志（原则上不使用debug调试程序）</li>
</ol>
<h2 id="2go-命令">2、GO 命令</h2>
<p><a href="https://go-zh.org/cmd/go/">GO命令</a> 的官方说明并不一定是最新版本。最新说明请使用命令 <code>go help</code> 获取。
<a href="https://go-zh.org/doc/articles/go_command.html">关于GO命令</a></p>
<p>必须了解的环境变量：<strong>GOROOT，GOPATH</strong><br>
<a href="https://go-zh.org/cmd/go/#hdr-GOPATH_environment_variable">项目目录与 gopath</a></p>
<h3 id="21-go-命令的格式">2.1 go 命令的格式</h3>
<p>使用：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-fallback" data-lang="fallback">go command [arguments]
</code></pre></td></tr></table>
</div>
</div><p>版本（go 1.8）的命令有：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span><span class="lnt">12
</span><span class="lnt">13
</span><span class="lnt">14
</span><span class="lnt">15
</span><span class="lnt">16
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-go" data-lang="go"><span class="nx">build</span>       <span class="nx">compile</span> <span class="nx">packages</span> <span class="nx">and</span> <span class="nx">dependencies</span>
<span class="nx">clean</span>       <span class="nx">remove</span> <span class="nx">object</span> <span class="nx">files</span>
<span class="nx">doc</span>         <span class="nx">show</span> <span class="nx">documentation</span> <span class="k">for</span> <span class="kn">package</span> <span class="nx">or</span> <span class="nx">symbol</span>
<span class="nx">env</span>         <span class="nx">print</span> <span class="nx">Go</span> <span class="nx">environment</span> <span class="nx">information</span>
<span class="nx">bug</span>         <span class="nx">start</span> <span class="nx">a</span> <span class="nx">bug</span> <span class="nx">report</span>
<span class="nx">fix</span>         <span class="nx">run</span> <span class="k">go</span> <span class="nx">tool</span> <span class="nx">fix</span> <span class="nx">on</span> <span class="nx">packages</span>
<span class="nx">fmt</span>         <span class="nx">run</span> <span class="nx">gofmt</span> <span class="nx">on</span> <span class="kn">package</span> <span class="nx">sources</span>
<span class="nx">generate</span>    <span class="nx">generate</span> <span class="nx">Go</span> <span class="nx">files</span> <span class="nx">by</span> <span class="nx">processing</span> <span class="nx">source</span>
<span class="nx">get</span>         <span class="nx">download</span> <span class="nx">and</span> <span class="nx">install</span> <span class="nx">packages</span> <span class="nx">and</span> <span class="nx">dependencies</span>
<span class="nx">install</span>     <span class="nx">compile</span> <span class="nx">and</span> <span class="nx">install</span> <span class="nx">packages</span> <span class="nx">and</span> <span class="nx">dependencies</span>
<span class="nx">list</span>        <span class="nx">list</span> <span class="nx">packages</span>
<span class="nx">run</span>         <span class="nx">compile</span> <span class="nx">and</span> <span class="nx">run</span> <span class="nx">Go</span> <span class="nx">program</span>
<span class="nx">test</span>        <span class="nx">test</span> <span class="nx">packages</span>
<span class="nx">tool</span>        <span class="nx">run</span> <span class="nx">specified</span> <span class="k">go</span> <span class="nx">tool</span>
<span class="nx">version</span>     <span class="nx">print</span> <span class="nx">Go</span> <span class="nx">version</span>
<span class="nx">vet</span>         <span class="nx">run</span> <span class="k">go</span> <span class="nx">tool</span> <span class="nx">vet</span> <span class="nx">on</span> <span class="nx">packages</span>
</code></pre></td></tr></table>
</div>
</div><h3 id="22-go-命令分类">2.2 go 命令分类</h3>
<ol>
<li>环境显示： version、env</li>
<li>构建流水线： clean、build、test、run、（publish/git）、get、install</li>
<li>包管理： list, get, install</li>
<li>杂项：fmt，vet，doc，tools &hellip;</li>
</ol>
<p>具体命令格式与参数使用 <code>go help [topic]</code></p>
<h2 id="3准备知识或资源">3、准备知识或资源</h2>
<h3 id="31-golang-知识整理">3.1 Golang 知识整理</h3>
<p>这里推荐 time-track 的个人博客，它的学习轨迹与课程要求基本一致。以下是他语言学习的笔记，可用于语言快速浏览与参考：</p>
<ul>
<li><a href="http://time-track.cn/gopl-notes-program-structure.html">《Go程序设计语言》要点总结——程序结构</a></li>
<li><a href="http://time-track.cn/gopl-notes-types.html">《Go程序设计语言》要点总结——数据类型</a></li>
<li><a href="http://time-track.cn/gopl-notes-function.html">《Go程序设计语言》要点总结——函数</a></li>
<li><a href="http://time-track.cn/gopl-notes-function.html">《Go程序设计语言》要点总结——方法</a></li>
<li><a href="http://time-track.cn/gopl-notes-interface.html">《Go程序设计语言》要点总结——接口</a></li>
</ul>
<p>以上仅代表作者观点，部分内容是不准确的，请用批判的态度看待网上博客。 切记：</p>
<ul>
<li>GO <strong>不是面向对象(<S>OOP</S>)</strong> 的。 所谓方法只是一种<a href="https://baike.baidu.com/item/%E8%AF%AD%E6%B3%95%E7%B3%96">语法糖</a>，它是特定类型上定义的操作（operation）</li>
<li>指针是没有 nil 的，这可以避免一些尴尬。 <code>p.X</code> 与 <code>v.x</code> (p 指针， v 值) 在语义上是无区别的，但实现上是有区别的 <code>p.x</code> 是实现 c 语言 <code>p-&gt;x</code> 的语法糖</li>
<li>zero 值好重要</li>
</ul>
<h3 id="32-json-序列化与反序列化">3.2 JSON 序列化与反序列化</h3>
<p>参考：<a href="https://blog.go-zh.org/json-and-go">JSON and Go</a><br>
json 包是内置支持的，文档位置：https://go-zh.org/pkg/encoding/json/</p>
<h3 id="33-复杂命令行的处理">3.3 复杂命令行的处理</h3>
<p>不要轻易“发明轮子”。为了实现 POSIX/GNU-风格参数处理，&ndash;flags，包括命令完成等支持，程序员们开发了无数第三方包，这些包可以在 <a href="https://godoc.org/">godoc</a> 找到。</p>
<ul>
<li>pflag 包： <a href="https://godoc.org/github.com/spf13/pflag">https://godoc.org/github.com/spf13/pflag</a></li>
<li>cobra 包： <a href="https://godoc.org/github.com/spf13/cobra">https://godoc.org/github.com/spf13/cobra</a></li>
<li>goptions 包： <a href="https://godoc.org/github.com/voxelbrain/goptions">https://godoc.org/github.com/voxelbrain/goptions</a></li>
<li>&hellip;</li>
<li>docker command 包：https://godoc.org/github.com/docker/cli/cli/command</li>
</ul>
<p><a href="http://www.xuebuyuan.com/1588520.html">go dead project</a> <strong>非常有用</strong></p>
<p>这里我们选择 cobar 这个工具。</p>
<p><strong>tip: 安装 cobra</strong></p>
<ul>
<li>使用命令 <code>go get -v github.com/spf13/cobra/cobra</code> 下载过程中，会出提示如下错误</li>
</ul>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-fallback" data-lang="fallback">Fetching https://golang.org/x/sys/unix?go-get=1
https fetch failed: Get https://golang.org/x/sys/unix?go-get=1: dial tcp 216.239.37.1:443: i/o timeout
</code></pre></td></tr></table>
</div>
</div><p>这是熟悉的错误，请在 <code>$GOPATH/src/golang.org/x</code> 目录下用 <code>git clone</code> 下载 <code>sys</code> 和 <code>text</code> 项目，然后使用 <code>go install github.com/spf13/cobra/cobra</code>, 安装后在 <code>$GOBIN</code> 下出现了 cobra 可执行程序。</p>
<p><strong>Cobra 的简单使用</strong></p>
<p>创建一个处理命令 <code>agenda register -uTestUser </code> 或 <code>agenda register --user=TestUser</code> 的小程序。</p>
<p>简要步骤如下：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-fallback" data-lang="fallback">cobra init
cobra add register
</code></pre></td></tr></table>
</div>
</div><p>需要的文件就产生了。 你需要阅读 <code>main.go</code> 的 <code>main()</code> ; <code>root.go</code> 的 <code>Execute()</code>; 最后修改 <code>register.go</code>, <code>init()</code> 添加：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-fallback" data-lang="fallback">registerCmd.Flags().StringP(&#34;user&#34;, &#34;u&#34;, &#34;Anonymous&#34;, &#34;Help message for username&#34;)
</code></pre></td></tr></table>
</div>
</div><p><code>Run</code> 匿名回调函数中添加：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-fallback" data-lang="fallback">username, _ := cmd.Flags().GetString(&#34;user&#34;)
fmt.Println(&#34;register called by &#34; + username)
</code></pre></td></tr></table>
</div>
</div><p>测试命令：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-fallback" data-lang="fallback">$ go run main.go register --user=TestUser
register called by TestUser
</code></pre></td></tr></table>
</div>
</div><p>参考文档：</p>
<ul>
<li><a href="https://github.com/spf13/cobra#overview">官方文档</a> <strong>推荐</strong></li>
<li><a href="https://www.cnblogs.com/borey/p/5715641.html">golang命令行库cobra的使用</a> 中文翻译</li>
</ul>
<h2 id="4agenda-开发项目">4、agenda 开发项目</h2>
<h3 id="41-需求描述">4.1 需求描述</h3>
<ul>
<li>业务需求：见后面附件</li>
<li>功能需求： 设计一组命令完成 agenda 的管理，例如：
<ul>
<li>agenda help ：列出命令说明</li>
<li>agenda register -uUserName &ndash;password pass &ndash;<a href="mailto:email=a@xxx.com">email=a@xxx.com</a> ：注册用户</li>
<li>agenda help register ：列出 register 命令的描述</li>
<li>agenda cm &hellip; : 创建一个会议</li>
<li>原则上一个命令对应一个业务功能</li>
</ul>
</li>
<li>持久化要求：
<ul>
<li>使用 json 存储  User 和 Meeting 实体</li>
<li>当前用户信息存储在 curUser.txt 中</li>
</ul>
</li>
<li>开发需求
<ul>
<li>团队：<strong>2-4人</strong>，一人作为 master 创建程序框架，其他人 fork 该项目，所有人同时开发。团队 <strong>不能少于 2 人</strong></li>
<li>时间：<strong>两周完成</strong></li>
</ul>
</li>
<li>项目目录
<ul>
<li>cmd ：存放命令实现代码</li>
<li>entity ：存放 User 和 Meeting 对象读写与处理逻辑</li>
<li>其他目录 ： 自由添加</li>
</ul>
</li>
<li>日志服务
<ul>
<li>使用 <a href="https://go-zh.org/pkg/log/">log</a> 包记录命令执行情况</li>
</ul>
</li>
</ul>
<h3 id="42-第一周任务">4.2 第一周任务</h3>
<ol>
<li>按 3.3 安装 cobra 并完成小案例</li>
<li>按需求设计 agenda 的命令与参数（制品 cmd-design.md）</li>
<li>master 创建项目，提交到 github， 其他人 fork 该项目</li>
<li>每人分别创建属于自己的命令（命令实现 Print 读取的参数即可），提交并归并。确保不同人管理不同文件，以便于协作</li>
<li>如时间富余，请完成 User 和 Meeting 实体 json 文件读写</li>
</ol>
<p><strong>思考</strong></p>
<p>假设你要建立项目 <code>testcobra</code>，你必须建立在 <code>$GOPATH\src\$your_git_account\$repo\testcobra</code> 目录下，才能正常实现协作。采用 golang 术语，<code>$GOPATH\src\$your_git_account\$repo\</code> 是你当前的 <strong>工作区</strong> 。</p>
<p><em>问题</em>：如果你的项目不能公开代码，甚至不能使用 github，如何实现多人协作呢？</p>
<h3 id="43-第二周任务">4.3 第二周任务</h3>
<ol>
<li>添加 log 服务，记录用户的操作过程，以及关键的输出</li>
<li>约定 <code>entity</code> 和 <code>cmd</code> 之间的接口服务，实现 agenda，并在 <code>README.md</code> 文件中给出简要使用说明和测试结果</li>
<li>（<strong>可选</strong>）在项目中添加 <code>.travis.yml</code> 文件，并添加测试程序。让你的项目“持续集成” &ndash; “CI” 了！</li>
</ol>
<p><strong>思考</strong></p>
<p>为什么 <code>cobra</code> 的设计，让我们构建命令行程序变的如此简单？如何持续提升我们的设计能力。</p>
<h3 id="44-可选任务博客">4.4 可选任务（博客）</h3>
<p>由于课程 golang 部分非常快，项目涉及许多知识点，需要您分享经验和英文资料翻译，以帮助您的同学入门。主要包括：</p>
<ul>
<li>运用面向对象的设计思想，仅使用 <code>pflag</code> 包，实现一个简版 <code>pcobra</code> 库取代 <code>cobra</code>（不需要 fork cobra）。并使得你的 agenda 项目能正常运行</li>
<li>git 和 travis 在项目中的使用经验</li>
<li>log 的使用与 debug 技术</li>
<li>go 语言的一些较难理解的知识</li>
</ul>
<p>分数，就是你贡献的回报！ 请在课程群博客收集提交博客 url</p>
<h3 id="45-评价标准">4.5 评价标准</h3>
<ul>
<li>提交与贡献均衡性与持续性（使用 Github Insights 分析）</li>
<li>Readme 的质量</li>
<li>部分代码检视</li>
</ul>
<h2 id="附件agenda-业务需求">附件：Agenda 业务需求</h2>
<p><strong>用户注册</strong></p>
<ol>
<li>注册新用户时，用户需设置一个唯一的用户名和一个密码。另外，还需登记邮箱及电话信息。</li>
<li>如果注册时提供的用户名已由其他用户使用，应反馈一个适当的出错信息；成功注册后，亦应反馈一个成功注册的信息。</li>
</ol>
<p><strong>用户登录</strong></p>
<ol>
<li>用户使用用户名和密码登录 Agenda 系统。</li>
<li>用户名和密码同时正确则登录成功并反馈一个成功登录的信息。否则，登录失败并反馈一个失败登录的信息。</li>
</ol>
<p><strong>用户登出</strong></p>
<ol>
<li>已登录的用户登出系统后，只能使用用户注册和用户登录功能。</li>
</ol>
<p><strong>用户查询</strong></p>
<ol>
<li>已登录的用户可以查看已注册的所有用户的用户名、邮箱及电话信息。</li>
</ol>
<p><strong>用户删除</strong></p>
<ol>
<li>已登录的用户可以删除本用户账户（即销号）。</li>
<li>操作成功，需反馈一个成功注销的信息；否则，反馈一个失败注销的信息。</li>
<li>删除成功则退出系统登录状态。删除后，该用户账户不再存在。</li>
<li>用户账户删除以后：
<ul>
<li>以该用户为 发起者 的会议将被删除</li>
<li>以该用户为 参与者 的会议将从 参与者 列表中移除该用户。若因此造成会议 参与者 人数为0，则会议也将被删除。</li>
</ul>
</li>
</ol>
<p><strong>创建会议</strong></p>
<ol>
<li>已登录的用户可以添加一个新会议到其议程安排中。会议可以在多个已注册
用户间举行，不允许包含未注册用户。添加会议时提供的信息应包括：
<ul>
<li>会议主题(title)（在会议列表中具有唯一性）</li>
<li>会议参与者(participator)</li>
<li>会议起始时间(start time)</li>
<li>会议结束时间(end time)</li>
</ul>
</li>
<li>注意，任何用户都无法分身参加多个会议。如果用户已有的会议安排（作为发起者或参与者）与将要创建的会议在时间上重叠 （允许仅有端点重叠的情况），则无法创建该会议。</li>
<li>用户应获得适当的反馈信息，以便得知是成功地创建了新会议，还是在创建过程中出现了某些错误。</li>
</ol>
<p><strong>增删会议参与者</strong></p>
<ol>
<li>已登录的用户可以向 自己发起的某一会议增加/删除 参与者 。</li>
<li>增加参与者时需要做 时间重叠 判断（允许仅有端点重叠的情况）。</li>
<li>删除会议参与者后，若因此造成会议 参与者 人数为0，则会议也将被删除。</li>
</ol>
<p><strong>查询会议</strong></p>
<ol>
<li>已登录的用户可以查询自己的议程在某一时间段(time interval)内的所有会议安排。</li>
<li>用户给出所关注时间段的起始时间和终止时间，返回该用户议程中在指定时间范围内找到的所有会议安排的列表。</li>
<li>在列表中给出每一会议的起始时间、终止时间、主题、以及发起者和参与者。</li>
<li>注意，查询会议的结果应包括用户作为 发起者或参与者 的会议。</li>
</ol>
<p><strong>取消会议</strong></p>
<ol>
<li>已登录的用户可以取消 自己发起 的某一会议安排。</li>
<li>取消会议时，需提供唯一标识：会议主题（title）。</li>
</ol>
<p><strong>退出会议</strong></p>
<ol>
<li>已登录的用户可以退出 自己参与 的某一会议安排。</li>
<li>退出会议时，需提供一个唯一标识：会议主题（title）。若因此造成会议 参与者 人数为0，则会议也将被删除。</li>
</ol>
<p><strong>清空会议</strong></p>
<ol>
<li>已登录的用户可以清空 自己发起 的所有会议安排。</li>
</ol>

    </div>

    <div class="post-copyright">
  <p class="copyright-item">
    <span class="item-title"></span>
    <span class="item-content">潘茂林</span>
  </p>
  <p class="copyright-item">
    <span class="item-title"></span>
    <span class="item-content">
        0001-01-01
        
    </span>
  </p>
  
  
</div>
<footer class="post-footer">
      
      <nav class="post-nav">
        <a class="prev" href="/service-computing/post/ex-install-go/">
            <i class="iconfont icon-left"></i>
            <span class="prev-text nav-default">安装 go 语言开发环境</span>
            <span class="prev-text nav-mobile"></span>
          </a>
        <a class="next" href="/service-computing/post/ex-cli-basic/">
            <span class="next-text nav-default"></span>
            <span class="next-text nav-mobile"></span>
            <i class="iconfont icon-right"></i>
          </a>
      </nav>
    </footer>
  </article>
        </div>
        

  

  

      </div>
    </main>

    <footer id="footer" class="footer">
      <div class="social-links">
      <a href="mailto:panml@mail.sysu.edu.cn" class="iconfont icon-email" title="email"></a>
  <a href="http://pmlpml.git.io/service-computing/index.xml" type="application/rss+xml" class="iconfont icon-rss" title="rss"></a>
</div>

<div class="copyright">
  <span class="power-by">
    %!(EXTRA string=<a class="hexo-link" href="https://gohugo.io">Hugo</a>)
  </span>
  <span class="division">|</span>
  <span class="theme-info">
     - 
    <a class="theme-link" href="https://github.com/olOwOlo/hugo-theme-even">Even</a>
  </span>

  

  <span class="copyright-year">
    &copy; 
    2018 - 
    2020
    <span class="heart">
      <i class="iconfont icon-heart"></i>
    </span>
    <span class="author">潘茂林</span>
  </span>
</div>
    </footer>

    <div class="back-to-top" id="back-to-top">
      <i class="iconfont icon-up"></i>
    </div>
  </div>
  
  <script src="https://cdn.jsdelivr.net/npm/jquery@3.2.1/dist/jquery.min.js" integrity="sha256-hwg4gsxgFZhOsEEamdOYGBf13FyQuiTwlAQgxVSNgt4=" crossorigin="anonymous"></script>
  <script src="https://cdn.jsdelivr.net/npm/slideout@1.0.1/dist/slideout.min.js" integrity="sha256-t+zJ/g8/KXIJMjSVQdnibt4dlaDxc9zXr/9oNPeWqdg=" crossorigin="anonymous"></script>
  <script src="https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@3.1.20/dist/jquery.fancybox.min.js" integrity="sha256-XVLffZaxoWfGUEbdzuLi7pwaUJv1cecsQJQqGLe7axY=" crossorigin="anonymous"></script>



<script type="text/javascript" src="/service-computing/js/main.min.d7b7ada643c9c1a983026e177f141f7363b4640d619caf01d8831a6718cd44ea.js"></script>








</body>
</html>
